home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / EMULATOR / SID2WAV / !Sid2Wav / docs / ReadMe < prev    next >
Text File  |  1997-07-05  |  7KB  |  157 lines
  1.  
  2. (NOTE:  This text accompanied the 1.14.4 version of the emulator.
  3.  I decided to keep it in the archive, even though some data is
  4.  now obsolete.  Refer to the other documents in this archive for
  5.  the correct e-mail addresses and web page URLs.
  6.              Sebastian Weinberg)
  7.  
  8.  
  9. Welcome to SIDPLAY !
  10.  
  11.  
  12. This package includes the complete source for the Unix version.
  13. For some system specific notes check out the other README files.
  14. So far there is support for Linux, FreeBSD, SunOS and Solaris 2
  15. SPARCstations, Silicon Graphics Indigo workstations. Support for
  16. any other operating system might be distributed in a separate package.
  17. Please note that this is development code. Hence there is also
  18. conditional 16/32-bit Windows code included.
  19.  
  20. This version is able to load data from standard input by handing in
  21. the input file name '-'. For example, uncompressing a gzip'ped music 
  22. file and piping the ouput to SIDPLAY is done like this:
  23.  
  24.  # gunzip -c rambo.dat.gz | sidplay -
  25.  
  26. SIDPLAY assumes data from standard input to be uncompressed and will
  27. not try to apply PowerPacker decompression. Further, reading from
  28. standard input does not work for sidtunes in multiple-files format.
  29.  
  30. The supported file formats are:
  31.  
  32.  - PlaySID single-file-format (PSID)
  33.  - PlaySID info-file-format 
  34.    (Raw C64 binary plus Amiga Workbench icon tooltype file)
  35.  - SIDPLAY info-file-format 
  36.    (Raw C64 binary plus SIDPLAY ASCII text info file)
  37.  - C64 Stereo-/Sidplayer format (MUS)
  38.  
  39. By convention, raw data or psid files were named '*.data', '*.psid' or 
  40. 'psid.*'. Additional icon info files were named '*.info', ASCII info files 
  41. were named '*.sid'. The multiple-files formats are obsolete, although they 
  42. are still supported. 
  43.  
  44. By default, SIDPLAY searches your directory for the following possible 
  45. combinations of files, if it doesn't succeed to determine the format of
  46. the single specified data file (* is the base filename):
  47.  
  48.  - a pair of a '*.data' and a '*.sid' file
  49.  - a pair of a '*.data' and a '*.info' file
  50.  - a pair of a '*' and a '*.sid' file 
  51.  - a pair of a '*' and a '*.info' file
  52.  
  53. Check out the command line arguments "-bs" and "-bn", if audio output
  54. gets interrupted when switching virtual consoles or running other 
  55. applications.
  56.  
  57. This version introduces 16-bit mixing. Enable it by using option '-16'.
  58. You will notice a slight improvement of the audio quality, though the
  59. fundamental waveforms are still 8-bit.
  60.  
  61.  
  62. PLAYSID COMPATIBILITY ISSUES:
  63.  
  64. If you use music collections which are especially made for PlaySID 
  65. (Amiga) you can safely use the command line argument "-a" (and 
  66. sometimes have to !) without getting unwanted results. If some tunes 
  67. are silent or sound strange in an undescribable manner, try toggling 
  68. the "-a" switch. If you encounter such a tune (or a real non-working 
  69. one), please contact me. 
  70.  
  71. Please note, that musics in PSID-single-file-format may have been 
  72. converted from SIDPLAY/DOS' format without any loss of data, but the 
  73. replay may cause problems due to a difference in PlaySID's and SIDPLAY's 
  74. emulation and way of handling and initializing the music data.
  75.  
  76. PlaySID pretends plain 64 KB of C64 random-access-memory to get rid 
  77. of C64-bank-switching, but does not allow the use of the memory range
  78. "under" the SID address space. Some sidtunes use this memory for large 
  79. data, e.g. samples in Chris Huelsbeck's "Chip Wars", and they sound
  80. damaged in PlaySID. The C64 uses bank-switching to map parts of the 
  81. ROM and I/O address space into the limited physical address space of 
  82. 64 KB. When SIDPLAY/DOS was developed from scratch, without any knowledge
  83. of PlaySID's inner workings, I decided to emulate bank-switching as well. 
  84. (The current implementation level of SIDPLAY/Linux does _not_ provide full 
  85. support for bank switching !). One benefit of this decision is the ability 
  86. to replay sidtunes that use any part of the C64 memory.
  87.  
  88. Attracted (or misguided ?) by the plain C64 memory of PlaySID, rippers
  89. of hundreds of sidtunes totally neglected bank-switching in the changes
  90. they did to the music players. Luckily, there are only a few tunes 
  91. where bank-switching would be necessary to successfully run them on a 
  92. real C64 or SIDPLAY. Concerning the latter, the tunes just stay silent 
  93. or, in the worst case, drop some notes or voices, e.g. Fred Gray's 
  94. "Army Moves", "Madballs", "Troll" or Martin Galway's "Mikie". Consider
  95. those sidtunes as PlaySID-specific, this means you have to enable the 
  96. "-a" option.
  97.  
  98. There is another problem with PlaySID-specific musics. In the early 
  99. development stages of SIDPLAY/DOS some users suggested the usage of all 
  100. three processor registers upon music initialization. Later we discovered
  101. some PlaySID tunes to assume certain register values (zero) upon
  102. initialization. These tunes don't run on a real C64 (where the processors'
  103. registers contain the last active value, which is unlikely to be zero !). 
  104. The "-a" option tells SIDPLAY to behave like PlaySID (use only one register 
  105. and clear the other two).
  106.  
  107.  
  108. PORTING & PATCHING:
  109.  
  110. This code is a C/C++ port of my DOS assembler language version 
  111. of SIDPLAY (actually, most of the code was hacked down in a
  112. single night). It is *not* optimized for speed and still lacks 
  113. some emulation features, but should already sound better than the
  114. DOS version ! If you look at the code and miss comments, this is 
  115. because I keep most of the documentation on paper (in German) 
  116. and in the original ASM files.
  117.  
  118. If you intend to port this code to another platform, please apply
  119. the changes in form of patches (diff -c). If you intend to improve 
  120. certain parts please consider contacting me to receive my latest
  121. revision group files in which you can log your changes. In both cases, 
  122. I would like to keep uptodate with the most recent patches by merging 
  123. your work with mine. Also, this makes sure you will get your credits 
  124. in later releases.
  125.  
  126.  
  127. BUGS & PROBLEMS:
  128.  
  129. If you encounter any bugs or problems, please don't hesitate to contact me. 
  130. This version was tested on Slackware 3.0.0 i386-Linux (extensively upgraded), 
  131. compiled using the configuration in README.Linux, together with VoxWare 3.0.1 
  132. on a SB 16 compatible soundcard.
  133.  
  134.  
  135.  
  136. Have fun !
  137.  
  138. Michael Schwendt <3schwend@informatik.uni-hamburg.de>
  139.  
  140. Also try http://www.student.nada.kth.se/~d93-alo/c64/Sidplay  
  141. for more information.
  142.  
  143.  
  144. THANKS to (in alphabetical order): 
  145.  
  146.            Åge Røbekk <aagero@aage.aage.priv.no>
  147.            Adam Lorentzon <d93-alo@nada.kth.se>
  148.            Andreas Varga <e9426444@stud1.tuwien.ac.at>
  149.            Brian Nielsen <norman@iesd.auc.dk>
  150.            Chris Cureau <davros@tecinfo.com>
  151.            Dimitri Ars <dimitri@pitel_lnx.ibk.fnt.hvu.nl>
  152.            Johan Köhler <drac@funcom.no>
  153.            Patrick van Logchem <v912152@si.hhs.nl>
  154.            Per Håkan Sundell <md1phs@mdstud.chalmers.se>
  155.            Toni Nikkanen <tonikk@utu.fi>
  156.  
  157.